home *** CD-ROM | disk | FTP | other *** search
/ STraTOS 1997 April & May / STraTOS 1 - 1997 April & May.iso / CD01 / ARCHIVER / YUVPAK2 / YUVPAK.DOC < prev    next >
Encoding:
Text File  |  1993-01-30  |  5.3 KB  |  130 lines
  1. January 31, 1993  (Go Cowboys!!!)
  2. YUVPAK is distributed WITHOUT ANY WARRANTY; without even the implied
  3. warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  4.  
  5.                               YUVPAK 2.0
  6.                                  for
  7.                        Fractal Image Compression
  8.                          (Color Targa Version)
  9.  
  10.                        *****  WHATS NEW? *****
  11.  
  12. 1.  Images are stored in 40 bits per transform... but still only 34 bits
  13. are significant.  If anybody wants to help with that... let me know.
  14.  
  15. 2.  All .ifs files begin with a 12 byte header.  It contains info that I
  16. wanted... but didn't want to write down.  Such as compression time, rms
  17. tolerance, and plenty of room for growth.
  18.  
  19. 3.  The go32 environment variable still has to be set for every program included.
  20.  
  21. 4.  Compression ranges between 10 and 45 to 1.
  22.  
  23.                        ***** Introduction *****
  24.  
  25. I posted this program to let some of the folks on the net know
  26. what's going on in the area of FRACTAL IMAGE COMPRESSION.
  27. For references:
  28.         ftp the file /pub/inls-ucsd/fractal-2.0.tar at lyapunov.ucsd.edu
  29. This is Yuval Fisher's paper... not mine.  It is in POSTSCRIPT.
  30. If you don't have ftp access, I will be uploading this document in a short
  31. time to local bbses.
  32.  
  33. The compression is a 2-level quadtree compression.  If you read the paper
  34. I use ranges of 8x8 and 4x4.  If you don't read the paper... then you won't
  35. know what I'm talking about, but it's not really important.
  36.  
  37. I really need to get more images to compress.  If you would like something
  38. compressed... get it to 256x256 and 24 bit color and in .TGA or .TIF format.
  39. Sharp images with good contrast are preferred... grain kills!
  40. If I think the image is worthy of my time... (it probably will be)
  41. I'll be glad to post a copy somewhere. 
  42.  
  43.                      ***** DISTRIBUTION STUFF *****
  44.  
  45. The program YUVUNPAK.EXE performs a decompression of images
  46. compressed using YUVPAK.EXE. (now included in this distribution)
  47.  
  48. YUVUNPAK was written in 'C', and compiled using GCC 1.09 for MSDOS systems.
  49. The source is included, along with some sample compressed images.
  50. (I'm a mathematician, not a 'C' programmer... I just dabble in 'C',
  51. no hate mail, please)
  52.  
  53. The files YUVUNPAK.EXE and YUVPAK.EXE are stubbized (gcc talk).  GO32.EXE
  54. must be in the path.
  55.  
  56.                   ***** GETTING YUVUNPAK.EXE TO RUN *****
  57.  
  58. YUVUNPAK.EXE and YUVPAK.EXE will run only on a 386 or higher.
  59. A math coprocessor is really required.
  60.  
  61. I recommend at least 1 meg of memory, but it will be _slow_.
  62. It is very fast as long as is doesn't have to page to disk.
  63.  
  64. Drivers for supported video cards are included.
  65. You'll have to decide by the driver filename whether there is
  66. one for your card.  These come straight from GCC 1.09 distribution.
  67.  
  68. You need to set the following environment variables:
  69.         set 387=yes
  70.         set GO32=driver "your .grd driver here, no quotes" gw 640 gh 480
  71.  
  72. The program is written to display at 640x480 with 256 shades of gray.
  73. (of course we know vga cards only display 6 bits worth)
  74. The 640x480 will allow you to see all of the data mentioned below.
  75. If all you can get is 320x200x256... it will run but you'll be missing
  76. alot.
  77.  
  78. syntax is:
  79.         YUVUNPAK foo.ifs foo.tga
  80.  
  81. To decompress 'peppers.ifs':
  82.         YUVUNPAK peppers.ifs peppersc.tga  (don't use a name that is already
  83.                                             taken.)
  84.  
  85. The peppers should appear... if not, check the parameters and make sure
  86. your GO32 variable is set to the right card.
  87.  
  88. After that the file peppersc.tga will be viewable.  You will probably
  89. have to dither it down to 256 colors to view it.  I recommend PICLAB's
  90. makepal option.
  91.  
  92. If you wish to compress your own files, they need to be 256x256 with
  93. 24 bits of color.  Only .TGA is supported currently.  Syntax is
  94.         YUVPAK rms infile.tga outfile.ifs  (the extensions are required)
  95.  
  96.         rms is a numerical value set by you.  It will affect the quality
  97.         and compression time.  A higher value will decrease quality
  98.         and compression time.  I usually use a value of 4.
  99.  
  100. There is very little error checking, so be careful and don't walk on any
  101. saved images.
  102.  
  103.                    ***** INFORMATION ON IMAGES *****
  104.  
  105. The images are _not_ stored optimally.  I'm still working on the actual
  106. compression routines, so I'm not concerned with writing the files out
  107. optimally just yet.  My thesis doesn't have to be finished until
  108. June 1993, so don't expect anything soon.
  109.  
  110. Each transformation uses 40 bits of storage, but only 34 bits
  111. are significant.  (I _think_ it will come down to 32 bits per
  112. transformation with no loss of quality)
  113. The number of transformations displayed at decompression time.
  114. There is also a 12 byte header.  The header info is for my benefit.
  115. It does not have anything to do with the actual decompression.
  116.  
  117. Thanks to DJ Delorie who made this work possible by porting
  118. GCC to MSDOS.  Send him money:
  119.                                  DJ Delorie
  120.                                  24 Kirsten Ave
  121.                                  Rochester NH  03867-2954
  122.  
  123. YUVPAK 2.0 is distributed WITHOUT ANY WARRANTY; without even the implied
  124. warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  125.  
  126. I can be contacted at wdy@tenet.edu.
  127.  
  128.  
  129. Copyright (C) 1993 WD Young
  130.